package com.nidu.demo.role.api;

import com.alibaba.cola.dto.MultiResponse;
import com.alibaba.cola.dto.PageResponse;
import com.alibaba.cola.dto.Response;
import com.alibaba.cola.dto.SingleResponse;
import com.nidu.demo.role.dto.RoleAddCmd;
import com.nidu.demo.role.dto.RoleListQry;
import com.nidu.demo.role.dto.RolePageQry;
import com.nidu.demo.role.dto.RoleUpdateCmd;
import com.nidu.demo.common.enums.StatusEnum;
import com.nidu.demo.role.dto.*;

import java.util.Set;

/**
 * 角色服务接口
 *
 * @author auto
 */
public interface SysRoleService {

    /**
     * 创建角色
     *
     * @param cmd 角色创建命令
     * @return 创建后的角色信息
     */
    SingleResponse<RoleCO> add(RoleAddCmd cmd);

    /**
     * 更新角色
     *
     * @param cmd 角色更新命令
     * @return 更新后的角色信息
     */
    SingleResponse<RoleCO> update(RoleUpdateCmd cmd);

    /**
     * 删除角色
     *
     * @param id 角色删除命令
     * @return 操作结果
     */
    Response delete(Long id);

    /**
     * 批量删除角色
     * @param ids
     * @return
     */
    Response delete(Set<Long> ids);

    /**
     * 获取角色详情
     *
     * @param id 角色ID
     * @return 角色详情
     */
    SingleResponse<RoleCO> getById(Long id);

    /**
     * 查询角色列表
     *
     * @param qry 查询条件
     * @return 角色列表
     */
    MultiResponse<RoleCO> list(RoleListQry qry);

    /**
     * 分页查询角色
     *
     * @param qry 分页查询条件
     * @return 分页结果
     */
    PageResponse<RoleCO> page(RolePageQry qry);

    /**
     * 修改状态
     *
     * @param id 角色Id
     * @param statusEnum 修改状态命令
     * @return 操作结果
     */
    Response updateStatus(Long id, StatusEnum statusEnum);

}